home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 March / Macworld (1998-03) (Disk 1).dmg / Shareware World / Utilities / Text Processing / Alpha / Help / Readme < prev    next >
Encoding:
Text File  |  1997-12-14  |  8.1 KB  |  161 lines  |  [TEXT/ALFA]
  1. Alpha version 7.0
  2.  
  3. International users: select your keyboard in the international 
  4. preferences dialog (Config->Global->Preferences->International).
  5.  
  6. Remember, Alpha has a Home Page, from which you can check for new 
  7. versions of Alpha, as well as the many modes and packages which have 
  8. been written.  If you wish to download those things directly you can 
  9. get them from <ftp://ftp.cs.umd.edu/~keleher/Alpha/packages/>, but 
  10. Alpha contains menu items to allow you to check for and/or download 
  11. and install updated items automatically.  Many packages are also 
  12. available from: <http://www.santafe.edu/~vince/pub/Alpha/>.  If you 
  13. check both locations, Alpha will keep track of which contains the 
  14. most recent one for you.  
  15.  
  16. Alpha has a detailed Manual, a shorter Quick Start (<-- click on it!)  
  17. document, and many other help files.  You can access the help files 
  18. under the system help menu.  If you have recently updated Alpha you 
  19. may wish to read the 'Changes' file.  If you previously used Alpha, 
  20. you may find some of its functionality missing: that's becuase it has 
  21. been placed in a separate package.  Read and download from the list of 
  22. packages below (or look in the packages menu to see if it was 
  23. pre-installed).
  24.  
  25. Please use the Alpha-D mailing list to discuss problems, suggestions 
  26. etc with this release.  To subscribe, email <LISTSERV@LISTSERV.SYR.EDU> 
  27. and, in the text of your message (not the subject line), write: 
  28. SUBSCRIBE ALPHA-D There are a number of known bugs which will hopefully
  29. be corrected in a future release.  See the 'Bug Reports and Debugging' 
  30. file for a list of these, and for information on how to track down 
  31. bugs you think you have found.
  32.  
  33. Starting with version 7.0, Alpha has a 'package' mechanism for extensions.  
  34. This allows the basic distribution to be small (if you downloaded the 
  35. 'minimal' version; the full version contains a number of packages 
  36. pre-installed), while being a lot more flexibile than previously.  You may 
  37. download any of a large number of these packages from one of Alpha's 
  38. internet sites (there are now more than thirty such packages available).  
  39. The Config->Packages menu lets you turn extensions on and off.
  40.  
  41. Alpha stores its preferences in a folder called 'Alpha-v7' in your 
  42. preferences folder.  Do not just copy over your old preferences.  Alpha has 
  43. undergone sufficient changes that it will probably be incompatible with many 
  44. existing preferences files.  See the end of this document for instructions 
  45. on copying over your preferences.
  46.  
  47. Scroll down to read a brief description of some of the current packages, and 
  48. click on the hyper-links to retrieve them from one of Alpha's package 
  49. archive sites.  You may also use the 'Config' menu, (select 'Alpha 
  50. Downloads') to download and install them.  Since most web browsers take so 
  51. long to startup, it may be better to start them up before clicking on any 
  52. link below (prevents time-out problems).
  53.  
  54. Click here to update Alpha's list of remote packages via the internet.
  55.  
  56. ===============================================================================
  57. Current extension packages for Alpha include:
  58.  
  59. Smart Paste --- when cutting and pasting code-segments, 'paste' will
  60.     automatically indent the code it pastes to match the surrounding code.
  61.     <get smartPaste.tcl>
  62. TeX mode --- powerful editing features for single or multi-part LaTeX 
  63.     documents.  Integrates well with all current TeX implementations.
  64.     <get TeXmode>
  65. HTML mode --- for editing and manipulating suites of Web pages, allowing
  66.     entire site maintenance from within Alpha.
  67.     <get HTMLmode>
  68. Perl mode --- for editing Perl documents
  69.     <get Perlmode>
  70. Emacs --- makes many of Alpha's key sequences mimic those of the popular
  71.     Unix editor 'Emacs'
  72.     <get Emacs>                     
  73. Macros --- allows you to record, save and replay keyboard macros.
  74.     <get macros.tcl>                    
  75. Diff mode --- powerful side-by-side comparison and patching between files or
  76.     directories.
  77.     <get DiffMode>
  78. Programmer's Menus --- menus for interacting with Symantec, Metrowerks and 
  79.     other common programming environments (primarily C, C++)
  80.     <get programmersMenus>
  81. Printer choices --- creates a printer sub-menu, allowing you to print using
  82.     Enscriptor, Kodex, Drop•ps or PrettyC as well as directly from Alpha.
  83.     <get printerChoicesMenu>        
  84. Ftp menu --- interaction with any of the popular Ftp clients.
  85.     <get ftpMenu.tcl>                   
  86. Vince's Additions --- a large suite of packages, used by many
  87.     Electric completions --- speeds up editing of C++, TeX, Java, Tcl 
  88.         documents with template insertions and sophisticated 'complete-
  89.         what-I-just-typed' features.
  90.     Electric menu --- to give menu access to some of the electric features.
  91.     Bib engine --- sophisticated interaction with Vince's port of BibTeX.
  92.     Bib convert --- conversion of Inspec and Hollis records to .bib format.
  93.     Mode search paths --- declare where you keep files/headers for different
  94.         modes so Alpha can find your files more easily.  Especially useful
  95.         for C++ programmers (finds those header files).
  96.     Document projects --- declare the projects your are working on, the
  97.         default document structures you use, and Alpha handles the rest.
  98.     File utils --- adds a few simple file utilities to Alpha's menus
  99.     <get VinceAdditions>           
  100. Voodoo menu --- interaction with the version control software 'Voodoo'
  101.     <get voodooMenu>                
  102. Copy ring --- maintain more than one piece of copied text for pasting.
  103.     <get copyRing.tcl>
  104. Compare windows --- find the next difference between two windows, very quickly,
  105.     and unobtrusively.
  106.     <get compareWindows.tcl> 
  107. Developer utilities --- to help you write new packages for Alpha.
  108.     <get developerUtilities.tcl>        
  109. Frontier menu --- interaction with Frontier.
  110.     <get frontierMenu>              
  111. Eudora menu --- interaction with Eudora; you can write your email in Alpha.
  112.     <get eudoraMenu>                
  113. Internet config menu --- interaction with Internet Config, and hence all of
  114.     your internet applications.
  115.     <get internetConfigMenu>        
  116. Recent Files --- maintains a menu of recently used files, for quick access.
  117.     <get recentFilesMenu.tcl>           
  118. Switch To --- keeps a menu of commonly used applications, for quick 
  119.     switching.
  120.     <get switchToMenu.tcl>              
  121. New Document --- instead of opening blank 'untitled' documents with cmd-N,
  122.     this package allow you to select a document type or template (if used
  123.     with the Document Projects package).  You can directly start an email
  124.     message, browse an ftp site, or create a new C++ class template.
  125.     <get newDocument.tcl>               
  126. Smarter Source --- allows you selectively to over-ride parts of Alpha's
  127.     core Tcl code without making changes to the core files (easier for you
  128.     to upgrade Alpha, keeping your changes intact).
  129.     <get smarterSource.tcl>             
  130.  
  131.  
  132.                      
  133. ===============================================================================
  134. Copying over old preferences:
  135.  
  136. Alpha stores most preferences in the 'defs.tcl' and 'arrdefs.tcl' files in 
  137. your preferences folder.  The preferences folder is in the standard system 
  138. preferences folder, and is named 'Alpha' (for versions < 7.0) or Alpha-v7
  139. for version 7 (and will be called Alpha-v8 when version 8.0 is released at 
  140. some point in the future...)
  141.  
  142. Some of your old preferences will be incompatible/irrelevant to the new 
  143. Alpha version when you upgrade from 6.x to 7.x therefore you shouldn't just 
  144. copy the two prefs files from one folder to the other.
  145.  
  146. Here's how to copy over just a few preferences: open the old 'defs.tcl' or 
  147. 'arrdefs.tcl' and examine them for lines you wish to copy.  Open the new 
  148. 'defs.tcl' and 'arrdefs.tcl'.  Alpha opens them in read-only mode, but you 
  149. can command-click on the 'lock' icon in the window to make the windows 
  150. modifiable.  Now copy and paste as you desire.  Finally save the windows and 
  151. quit and restart Alpha.  If you get an error on startup, you probably copied 
  152. over incompatible preferences and you'll have to delete the files and start 
  153. over (hence it may be a good idea to make a backup copy of the originals 
  154. before you start).
  155.  
  156. Note: if you don't wish to use a System-Folder prefs folder, create a folder
  157. called 'AlphaPrefs' next to the Alpha application.  Alpha will use that
  158. folder preferentially if it exists.
  159.  
  160.  
  161.